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USB 驱动 编写 





Lusb 驱动 程序 的 编写 : 分 析 linux 内 核 的 usb 骨架 代码 usb_skeleton.c 
说 明 : 一 个 usb 设备 有 若干 个 配置 组 成 ， 每 一 个 配置 又 可 以 有 多 个 接口 ， 每 一 个 
接口 又 有 多 个 设置 

而 接口 本 身 又 有 可 能 没有 端点 或 者 多 个 端点 。usb 的 数据 交换 是 通过 端点 进 
行 的 。 

usb 的 接口 分 为 控制 接口 、 中 断 接口 、 批 量 接口 、 等 时 接口 。 

在 linux 中 端点 使 用 数据 接口 struct usb host Sead iil 来 描述 usb 的 端点 信息 

在 linux 中 接口 使 用 struct usb_interface 来 描述 。 

在 linux 中 整个 usb 设备 可 以 使 用 struct usb_ device 结构 来 描述 。 

TE linux HY) usb 驱动 程序 中 ,ehci 每 次 发 送 的 数据 包 大 小 最 好 为 512, 根据 linux 
内 核 代码 说 明 得 出 的 
/* MAX TRANSFER is chosen so that the VM is not stressed by allocations > 
PAGE SIZE and the number of packets in a page is an integer 512 is the largest 
possible packet on EHCI */ 




















usb 驱动 程序 编写 流程 : 
1. 注 册 usb 子 系统 usb en driver); 
说 明 :skel_driver 是 描述 驱动 信息 的 结构 体 


定义 一 个 id_table 结构 体 ， 来 描述 内 核 允许 该 模块 所 支持 的 硬件 设备 
/不 带 背 景色 的 代码 


#define USB SKEL VENDOR ID  Oxfff0 

#define USB SKEL PRODUCT ID Oxfff0 

/* table of devices that work with this driver */ 

static struct usb device id skel table [] = { 
{ USB DEVICE(USB SKEL VENDOR ID, USB SKEL PRODUCT ID) }, 
{} /* Terminating entry */ 





HE 








这 个 结构 体 的 最 后 一 个 元 素 必 须 为 空 ， 用 来 标识 结束 符 


MODULE DEVICE TABLE(usb, skel table); 
module device table 用 来 描述 设备 类 型 ， 如 果 是 usb KH, APA usb, WE pci 
设备 那么 就 是 MODULE DEVICE TABLE(pci, skel table); 

// 带 背景 色 的 代码 


static struct usb driver skel driver = { 
.name = "skeleton", /* 驱动 名 称 * 
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.probe =skel_ probe, * 操作 函数 */ 

.disconnect =  skel disconnect, /* 断 开 函数 */ 

.suspend = skel suspend, 

.resume = skel resume, 

.pre reset = skel pre reset, 

.post reset =skel post reset, 

id table = skel table, 

.Supports autosuspend = |, 
}; 
其 中 name probe disconnect 以 及 id table 是 必须 的 ,其 他 的 可 以 看 情况 添 不 添加 。 
id_table 用 来 告诉 内 核 该 模块 支持 的 设备 ，usb 子 系统 通过 设备 的 protect id 和 
vendor id_ table 
的 组 合 或 者 设备 的 class, subclass 和 protocol 的 组 合 来 识别 设备 。 





如 果 一 个 usb 设备 接 入 到 系统 中 ， 他 的 protect id 和 vendor id 符合 我 们 注册 的 ， 
那么 久 会 调用 这 个 模块 
作为 该 设备 的 驱动 程序 。 


2. 定 义 一 个 描述 该 驱动 以 及 拥有 所 有 资源 和 状态 的 结构 体 ， 这 个 结构 体 是 程序 员 
自己 按照 驱动 需求 定义 的 


struct usb_skel { 


struct usb_device*udev; /* the usb device for this device */ 

struct usb interface *interface; /* the interface for this device */ 

struct semaphore limit_sem; /* limiting the number of writes in progress */ 

struct usb_anchor submitted; /* in case we need to retract our 
submissions */ 

unsigned char *bulk in buffer; /* the buffer to receive data */ 

size_t bulk_in_ size; /* the size of the receive buffer */ 

__u8 bulk in endpointAddr; /* the address of the bulk in endpoint 
i 

__u8 bulk out endpointAddr; /* the address of the bulk out 
endpoint */ 

int errors; /* the last request tanked */ 

int open count; /* count the number of openers */ 

spinlock_t err_lock; /* lock for errors */ 

struct kref kref; 

struct mutex io_mutex; /* synchronize I/O with disconnect */ 
3; 





分 析 : 这 个 结构 体 拥 有 一 个 描述 usb 设备 的 结构 体 udev, 一 个 接口 interface, 一 个 用 
于 接收 数据 的 输入 缓冲 bulk in buffer 

以 及 大 小 bulk in_size， 批 量 的 输入 输出 端口 地 址 bulk in_endpointAddr、 
bulk out endpointAddr。 这 些 变量 是 一 个 
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usb 驱动 程序 所 必须 使 用 到 的 


3. 编 瑟 probel 函数 static int skel probe(struct usb_interface *interface, const struct 
usb device id *id) 
当 调 用 这 个 函数 的 时 候 ， 系 统 会 传递 一 个 usb interface 和 id 他 们 分 别 是 该 usb 
设备 的 接口 描述 符 (一 般 会 是 该 设备 的 第 0 号 接口 
， 该 接口 的 0 号 配置 ， 以 及 设备 描述 id--protect id 和 vendor id) 
skel probe 函数 主要 需要 实现 下 面 的 一 些 代码 程序 : 
dev->udev = usb get dev(interface to usbdev(interface)); 
说 明 :interface to _usbdev(interface) /* 得 到 该 usb 的 设备 描述 符 */ 
usb get dev 函数 是 增加 对 该 usb device 的 引用 计数 的 ， 我 们 应 该 在 操作 该 设备 
的 时 候 增加 引用 计数 ， 释 放 usb 的 时 候 减 少 引用 计数 
注意 :这 里 的 引用 计数 是 对 usb device 的 计数 ， 不 是 对 模块 的 计数 ,在 编写 驱动 程 
序 的 时 候 我 们 可 以 不 进行 计数 。 
dev->interface = interface; /* 得 到 该 设备 的 接口 描述 符 */ 
在 得 到 usb device 之 后 , 我 们 需要 对 usb_skel 结构 体 进行 初始 化 , 这 部 分 工作 的 
任务 主要 是 向 usb_skel 注册 该 usb 设备 的 端点 

/* set up the endpoint information */ 

/* use only the first bulk-in and bulk-out endpoints */ 

iface desc = interface->cur altsetting; /* 获取 当前 接口 设置 */ 

for (i = 0; 1<iface_desc->desc.bNumEndpoints; ++i) { 

endpoint = &iface_desc->endpoint[i].desc; /* 得 到 端点 描述 符 */ 


























if ((dev->bulk_in_endpointAddr && 
usb_endpoint_is bulk _in(endpoint)) { /* 检查 端点 的 类 型 和 输出 方向 
+ 
/* we found a bulk in endpoint */ 
PUR RATR EURE ii À Ho +, AB EAT EB! usb_skel 中 */ 
buffer Size = le16 to cpu(endpoint->wMaxPacketSize); 
dev->bulk in size = buffer size; 
dev->bulk_in_endpointAddr = endpoint->bEndpointAddress; 
dev->bulk_in_buffer = kmalloc(buffer size, GFP KERNEL); /* 分 
配 输出 缓存 */ 
if (1dev->bulk in buffer) { 
err("Could not allocate bulk in buffer"); 
goto error; 


} 


* 如 果 检 查 到 该 usb 的 端点 类 型 是 输出 端点 保存 输出 端点 的 信息 到 
usb_skel 中 */ 
if (!dev->bulk out endpointAddr && 
usb endpoint is bulk out(endpoint)) { 
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/* we found a bulk out endpoint */ 
dev->bulk_out_endpointAddr = endpoint->bEndpointAddress; 
} 
if ({(dev->bulk in endpointAddr && dev->bulk_out_endpointAddr)) { 
err("Could not find both bulk-in and bulk-out endpoints"); 
goto error; 
} 
} 
说 明 : 在 usb_host_interface 结构 体 里 面 有 一 个 usb_interface_descriptor 的 叫做 desc 
的 成 员 ， 它 用 来 描述 interface 
的 一 些 属性 ，bNumEndpoints 是 一 个 8 位 的 数字 ， 代 表 端 口 的 端点 数 ，proble K 
数 便利 所 有 的 端点 ， 检 查 他 们 的 类 型 和 方向 
;并且 注册 到 usb_skel 中 端点 是 根据 HID 规范 来 的 (什么 是 HID 规范 ) 























usb_set_intfdata(interface, dev); /* 问 系 统 注 册 usb skel*/ 
说 明 : 这 个 函数 注册 的 数据 结构 是 任意 的 ， 只 是 为 了 我 们 以 后 用 usb_get_intfdata 
可 以 得 到 我 们 想 要 的 数据 结构 

















接 下 来 我 们 可 以 注册 一 个 文件 操作 函数 集 , 这 个 才 是 usb 设备 的 真正 操作 函数 集 
人 
oO 
static struct usb class driver skel_class = { 
.name = "skel%d", 
.fops = &skel_fops, 
.minor base= USB SKEL MINOR BASE, 


HE 


/* we can register the device now, as it is ready */ 
retval = usb register dev(interface, &skel class); 
if (retval) { 
/* something prevented us from registering this driver */ 
err(""Not able to get a minor for this device."); 
usb set_intfdata(interface, NULL); 
goto error; 


4.usb 设备 断 开 函数 

当 设备 被 拔 出 集线器 的 时 候 ，usb 子 系统 会 自动 的 调用 disconnect 函数 ， 它 主要 
是 注销 class device 

static void skel_disconnect(struct usb interface *interface) 


{ 





struct usb_skel *dev; 
int minor = interface->minor; 
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dev = usb get intfdata(interface); 
usb set_intfdata(interface, NULL); 


/* give back our minor */ 
usb deregister dev(interface, &skel_ class); 


/* prevent more I/O from starting */ 
mutex lock(&dev->io mutex); 
dev->interface = NULL; 

mutex unlock(&dev->io mutex); 


usb kill anchored urbs(&dev->submitted); 


/* decrement our usage count */ 
kref put(&dev->kref, skel delete); 


dev_info(&interface->dev, "USB Skeleton #%d now disconnected", minor); 


} 
usb 操作 函数 集 接口 初始 化 流程 说 明 : 


static const struct file operations skel fops = { 
.owner = THIS MODULE, 


.read = skel read, 
.Write = skel write, 
.open = skel_ open, 
.release =  skel release, 


.flush = skel flush, 
35 
在 这 个 结构 体 里 面 的 操作 函数 集 主 要 是 对 usb 设备 的 具体 的 操作 , 包括 数据 的 发 
送 与 接收 ,usb 数据 的 发 送 与 接收 是 通过 urb 进行 的 
urb 好 比 高 速 公路 上 的 汽车 ， 他 可 以 运载 usb 的 4 种 数据 流 ， 不 过 你 需要 向 告诉 
司机 李 需 要 运 什么 ， 目 的 地 是 什么 。 

















1 .创建 urb usb alloc_urb(0, GFP KERNEL); 
第 一 个 函数 是 等 时 包 的 数量 ， 如 果 不 是 承载 的 等 时 包 ， 应 该 为 0, 第 二 个 参数 与 
kmalloc 。 
要 释放 一 个 urb 可 以 用 :usb_free_urb 函数 
要 承载 数据 , 我 们 还 需要 告诉 司机 目的 地 址 信息 和 需要 运送 的 货物 , 对 于 不 同 的 
数据 ， 系 统 提供 了 不 同 的 函数 (4 种 ) 
下 面 是 一 个 urb 使 用 的 方法 (批量 传输 ) 
usb fill bulk urb(urb, dev->udev, 
usb sndbulkpipe(dev->udev, dev->bulk out endpointAddr), 
buf, writesize, skel write bulk callback, dev); 
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urb->transfer flags [= URB NO TRANSFER DMA MAP;/* 不 要 再 让 HCD 做 
DMA 映射， 相当 于 DMA 映射 已 经 做 好 了 */ 


usb anchor urb(urb, &dev->submitted); 


/* send the data out the bulk port */ 

retval = usb submit urb(urb, GFP_KERNEL); 

说 明 :skel_ write bulk_callback 是 回调 函数 我 们 可 以 在 urb 传输 完成 之 后 通过 
status 判断 urb 是 否 正常 传输 成 功 

如 果 不 成 功 ， 正 确 的 做 法 应 该 是 重新 提交 urb。 


static void skel write bulk callback(struct urb *urb) 





{ 
struct usb skel *dev; 
dev = urb->context; 
/* Sync/async unlink faults aren't errors */ 
/* 正确 的 做 法 是 如 果 urb 传输 错误 应 该 重新 提交 urb */ 
if (urb->status) { 
printk("urb error!\r\n"); /* 如 果 urb 提交 错误 */ 
} 
else 
printk("urb success!\rin"};  /* 如 果 正 常 提交 urb */ 
} 
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usb_sndbulkpipe: 这 个 函数 是 根据 设备 和 端点 生成 
管道 ， 对 应 的 还 有 

#define usb_sndctrlpipe(dev,endpoint) 控制 发 送 
#define usb_rcvctrlpipe(dev,endpoint) 控制 接收 
#define usb_sndisocpipe(dev,endpoint) 等 时 发 送 
#define usb_rcvisocpipe(dev,endpoint) 等 时 接收 
#define usb_sndbulkpipe(dev,endpoint) ”批量 发 i 
#define usb_rcvbulkpipe(dev,endpoint) 批 量 接 收 
#define usb_sndintpipe(dev,endpoint) 中 断 发 送 
#define usb_rcvintpipe(dev,endpoint) 中 断 接 收 
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说 明 : 一 个 参数 是 urb, 第 二 个 参数 是 usb 的 设备 ,第 三 个 参数 是 管道 号 码 pipe. 14 
管道 记录 了 目标 设备 的 端点 以 及 管道 的 类 型 

， 每 一 个 管道 只 有 一 种 类 型 和 一 个 方向 ， 它 与 他 的 目标 设备 的 端点 相对 应 ， 
usb_sndbulkpipe 函数 可 以 把 指定 的 usb 设备 的 指定 端点 

















这 里 指定 成 为 一 个 批量 out 端点 (还 有 类 似 的 函数 可 以 设置 成 为 控制 out 端点 , 控 


中 断 out 端点 ， 等 时 int 端点 ， 等 时 out 端点 ， 等 时 in 端点 ), 第 四 个 参数 是 需要 发 


送 的 数组 ， 第 五 个 参数 是 发 送 数组 的 长 度 ， 


第 六 个 参数 是 发 送 完成 之 后 的 回调 函数 ， 当 发 送 完成 之 后 , 这 个 函数 会 被 自动 调 
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用 ， 一 般 在 这 个 函数 中 ， 
可 以 通过 判断 urb->status 的 值 , 来 判断 成 功 传输 与 否 。 第 六 个 参数 是 用 户 自己 定 
义 的， 是 可 能 在 回调 函数 中 使 用 的 数据 。 





注意 :在 write 中 申请 的 部 分 资源 ， 比 如 说 每 次 调用 write 都 会 申请 的 资源 ， 例 如 
urb 和 buff， 强 烈 建议 在 发 送 完 成 的 回调 函数 中 手动 
释放 。 











urb->transfer flags |= URB NO TRANSFER DMA MAP; /* 这 句 话 的 意思 就 
是 使 用 dma 传输 */ 
usb submit urb(urb, GFP KERNEL); /* 启动 usb 传输 */ 











事实 上 ， 如 果 数 据 量 不 大 ， 那 么 可 以 不 一 定 需要 用 卡车 来 运 货 ， 系 统 还 提供 了 一 
种 不 用 urb 的 传输 方式 ， 而 usb_skeleton 的 读 操作 正式 
采用 了 这 种 方式 实现 。 
/* do a blocking bulk read to get data from the device */ 
retval = usb bulk msg(dev->udev, 
usb rcvbulkpipe(dev->udev, dev->bulk in endpointAddr), 
dev->bulk in buffer, 
min(dev->bulk in size, count), 
&bytes read, 10000); 





/* if the read was successful, copy the data to userspace */ 
if (tretval) { 
if (copy_to_user(buffer, dev->bulk in buffer, bytes read)) 
retval = -EFAULT; 
else 
retval = bytes_read; 


函数 原型 :int usb bulk msg(struct usb device *usb dev, unsigned int pipe, 

void *data, int len, int *actual length, int timeout) 
说 明 : 这 个 函数 会 阻塞 等 待 数据 的 传输 完成 或 者 超时 ，data 是 输入 /输出 缓冲 ,len 
是 它 的 长 度 大 小 ，actual_ length 
是 实际 传输 的 数据 的 大 小 ,timeonut 设置 超时 ， 这 个 函数 也 是 批量 传输 数据 的 usb 
发 送 函 数 ， 只 不 过 没有 使 用 urbo 











以 上 是 发 送 urb， 如 果 是 需要 接收 数据 ， 那 么 只 需要 调用 接收 urb 函数 即 可 
retval = usb bulk msg(dev->udev, 
usb rcvbulkpipe(dev->udev, dev->bulk in endpointAddr), 


nA BW D = 


dev->bulk in buffer, 
min(dev->bulk in size, count), 
&bytes read, 10000); 

以 上 就 是 usb 发 送 和 接收 的 全 部 流程 。 


块 设备 驱动 编写 


块 设备 驱动 程序 : 

块 设备 读 写 数据 的 基本 单位 是 块 ， 例 如 一 个 磁盘 通常 为 一 个 sector( 肩 区) 
block device 结构 代表 了 内 核 中 的 一 个 块 设备 ， 他 可 以 标识 整个 磁盘 或 者 一 个 特 
定 的 分 区 。 当 这 个 结构 代表 一 个 
分 区 的 时 候 ， 它 的 bd contains 成 员 指 向 包含 这 个 分 区 的 设备 ，bd_part 成 员 指 问 
设备 的 gendisk 结构 。 














gendisk 是 一 个 单独 的 磁盘 驱动 器 的 内 核 表示 ， 内 核 还 使 用 gendisk 来 表示 分 区 。 
gendisk 结构 的 操作 函数 集合 包含 了 一 下 几 个 :alloc_gendisk /* 分 配 人 磁盘 */ 

add disk /* 增加 磁盘 信息 * 

unlink gendisk /* 删除 磁盘 信息 */ delete partition /* 删除 分 区 */ add partition 
* 添加 分 区 */ 








block device operations 类 似 于 支付 设备 驱动 里 面 的 file_operations 结构 , 它 是 块 
设备 的 对 应 接口 ， 
这 里 面 定 义 的 是 块 设备 的 操作 函数 集 
函数 原型 : 
struct block device operations { 
int (*open) (struct block device *, fmode t); 
int (*release) (struct gendisk *, fmode t); 
int (*locked_ioctl) (struct block device *, fmode t, unsigned, unsigned long); 
int (*ioctl) (struct block device *, fmode t, unsigned, unsigned long); 
int (*compat_ioctl) (struct block device *, fmode t, unsigned, unsigned long); 
int (“direct access) (struct block device *, sector t, 
void **, unsigned long *); 
int (*media changed) (struct gendisk *); 
int (*revalidate_disk) (struct gendisk *); 
int (*getgeo)(struct block_device *, struct hd_geometry *); 
struct module *owner; 








HE 
说 明 : 


static struct block device operations ramblock fops={ 
.owner = THIS MODULE, 
.getgeo =ramblock getgeo, 

}; 
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系统 对 块 设备 进行 读 取 操作 时 , 是 通过 块 设备 通用 的 读 写 操作 函数 将 一 个 请 求 保 
存在 该 设备 的 操作 请 求 队列 中 ， 

然后 调用 这 个 块 设备 的 底层 处 理 函 数 ， 对 请 求 队列 中 的 操作 请 求 进行 逐一 执行 ， 
request_queue 结构 描述 了 块 设备 

的 请 求 队列 。 

请 求 队列 拥有 一 系列 相关 的 处 理 函 数 : 创建 队列 时 提供 了 一 个 自 旋 锁 
blk_init_queue、 获 取 队 列 中 第 一 个 未 完成 的 请 求 

elv net request、 请 求 完 成 end_request、 请 求 停止 blk stop queue、 开 始 请 求 
blk_start_queue、 清 除 请 求 队列 blk_clenup_queue 





























块 设备 驱动 程序 编程 : 

1. 初 始 化 请 求 队列 

blk init queue(do ramblock request, &ramblock lock); 

说 明 : 该 函数 的 第 一 个 参数 是 请 求 处 理 函 数 的 指针 ， 第 二 个 参数 是 控制 访问 队列 
的 权限 的 自 旋 锁 (在 编写 对 应 的 驱动 程序 的 时 候 ， 一 定 要 检测 返回 值 )。 

请 求 处 理 函 数 不 能 由 驱动 自己 调用 , 只 有 当 内 核 认 为 是 时 候 让 驱动 处 理 对 设备 的 
读 写 等 操作 时 ， 它 才 会 调用 这 个 函数 。 

对 于 ramdisk 这 种 完全 随机 访问 的 非 机 械 设 备 ， 并 不 需要 复杂 的 IO 调度 ， 这 个 
时 候 ， 可 以 直接 跑 开 "LO 调度 器 "， 使 用 如 下 的 

函数 来 绑 定 请 求 队列 和 制造 请 求 的 函数 (make_request_fn) 

void blk queue make request(struct request queue *q, make request fn *mfn) 

说 明 :blk alloc queue 和 blk queue make request 结合 起 来 使 用 的 逻辑 一 般 是 
xxx queue =blk alloc queue(GPF KERNEL) 

blk queue make request(xxx queue, xxx make request) 









































2. 注 册 块 设备 

register_blkdev(0, "ramblock"); /* cat /proc/devices */ 

说 明 :; 块 设备 的 注册 和 支付 设备 一 样 的 ， 有 自己 的 设备 名 字 和 设备 号 ， 如 果 主 设 
备 号 为 0， 那 么 内 核 会 自动 分 配 一 个 新 的 主 设备 号 ， 

一 般 情 况 下 ， 默 认 写 0。 该 函数 正常 返回 的 是 主 设备 号 ， 就 是 major 的 值 








3 .分 配 一 个 gendisk 结构 (gendisk 在 linux 内 核 中 用 来 标识 一 个 独立 的 设备 或 者 分 
区 ) 

alloc_disk(16); = 次 设备 号 个 数 : 分 区 个 数 +1 */ 

说 明 :alloc_ disk 的 参数 代表 次 设备 号 ， 同 一 个 磁盘 的 各 个 分 区 共享 一 个 主 设备 
号 ， 而 此 设备 号 则 不 相同 ， 所 以 这 里 的 此 设备 号 

可 以 用 来 代表 分 区 的 个 数 ， 因 为 次 设备 号 是 从 0 开始 的 ， 所 以 是 参数 +1 个 分 区 。 


4. 当 我 们 分 配 好 gendisk 结构 后 ， 我 们 需要 初始 化 gendisk， 设 置 其 属性 

1). 设 置 gendisk 的 请 求 队列 ramblock disk->queue = ramblock queue; 

2). 设 置 主 设备 号 ramblock disk->major = major; 

3). 分 配 次 设备 号 ramblock disk->first minor = 0; /* 相当 于 分 区 的 起 始 号 在 此 
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后 的 程序 中 该 值 不 能 够 修改 */ 

4). 指 定 块 设备 的 操作 函数 集合 ramblock_disk->fops = &ramblock_fops; 
5). 设 置 gendisk 的 name EX sprintf(ramblock_disk->disk_name, "ramblock"); 

0). 设 置 扇 区 大 小 set capacity(ramblock disk, RAMBLOCK SIZE / 512); /* 配置 
各 个 而 区 的 容量 */ 

7). 注 册 磁 盘 设 备 (gendisk 结构 分 配 之 后 还 不 能 马上 被 使 

用 )add disk(ramblock disk); 














说 明 : 在 块 设备 的 和 钊 载 过 程 中 完成 与 模块 加 载 函 数 相 反 的 工作 
1) 清 除 请 求 队列 ， 使 用 blk_cleanup_queue 

2) 删 除 对 gendisk 的 引用 ， 使 用 put disk 

3) 删 除 对 块 设备 的 引用 ， 注 销 块 设备 驱动 ， 使 用 unregister_blkdev 


5. 在 我 们 初始 化 gendisk 结构 体 之 后 ， 我 们 需要 填充 file_ ops 结构 

主要 的 操作 函数 说 明 : 

1) 获 取 驱 动 器 信息 int (*getgeo)(struct block device *, struct hd geometry *);( 疑 问 : 
这 个 函数 在 什么 时 候 被 调用 ? ) 

static int ramblock getgeo(struct block device *bdev, struct hd_geometry *geo) 


{ 





PR 这 些 值得 设置 是 按照 我 们 分 配 的 内 存 大 小 设置 出 来 的 */ 
/* 容量 =heads*cylinders*sectors*512 */ 

geo->heads = 2; 

geo->cylinders = 32; 

geo->sectors =RAMBLOCK SIZE/2/32/512; 

return 0; 


6. 编 写 request queue 请 求 函 数 


ARS 


1) 提 交 请 求 blk peek request(struct request_queue *q) 
说 明 :上 述 函 数 返回 一 个 要 处 理 的 请 求 (由 IO 调度 器 决定 ), 如 果 没 有 请 求 则 返回 
NULL， 它 不 会 清楚 请 求 ， 而 是 仍然 将 这 个 请 求 保留 在 队列 
E, JRORAE elv next request 函数 已 经 不 再 使 用 了 (新 版 本 的 内 核 才 会 使 用 
提交 请 求 blk peek request， 如 果 内 核 中 没有 这 个 函数 ， 请 
使 用 老 版 本 的 函数 elv_next request). 























2) 启 动 请 求 

void blk start request(struct request “req) 

说 明 : 从 请 求 队列 中 移 除 请 求 ， 原 先 老 的 API blkdev dequeue requestO0 会 在 
blk_start_request() 内 部 被 调用 。 

我 们 可 以 考虑 是 用 blk_fetch_request0 函 数 ， 它 同时 做 完了 blk_peek_request 和 
blk_start request 的 工作 。 


3) 报 告 完 成 


它 拥有 一 系列 的 blk_end_xxx 函数 ， 如 果 我 们 使 用 了 blk queue make request 2% 
开 了 io 调度 ， 那 么 在 bio 出 来 完成 之 后 使 用 bio_endio0 
函数 来 通知 处 理 结束 。 

















I2C 驱动 编写 


i2c 驱动 编写 : 参考 韦 东山 的 i2c 驱动 代码 和 linux 内 核 自 带 的 驱动 代码 

i2c 驱动 主要 分 为 linux i2c 总 线 驱动 和 设备 驱动 , 总 线 驱 动 一 般 已 经 提供 好 了 的 ， 
我 们 主要 是 开发 对 应 的 具体 外 设 的 设备 驱动 

说 明 : 编 写 i2c 设备 驱动 有 两 种 方法 ， 一 种 是 利用 系统 给 我 们 提供 的 i2c-dev.c 来 
实现 一 个 i2c 适配器 来 控制 i2c 设备 ， 我 们 需要 在 应 用 
程序 去 封装 数据 , 我 们 需要 做 的 就 是 在 应 用 层 来 填充 i2c_masg 结构 体 来 向 驱动 层 
传递 数据 。 另 一 种 是 为 了 i2c 

设备 ， 独 立 编写 一 个 设备 驱动 程序 。 说 明 : 在 后 面 一 种 情况 下 ， 不 需要 使 用 


12c-dev.c。 





















































利用 i2c-dev.c 作为 适配器 ， 进 而 控制 i2c 设备 。i2c-dev.c 并 没有 针对 特定 的 设备 
而 实现 ， 只 是 提供 了 通用 的 read、write 和 ioctl 等 接口 

应 用 层 可 以 借用 这 些 接 口 访问 挂 载 在 i2c 适配器 上 面 的 i2c 设备 。 

说 明 : 该 文件 只 适合 单 开始 信号 , 对 于 多 开始 信号 需要 单独 编写 i2c 设备 驱动 程序 











下 面 分 析 i2c 的 普通 驱动 ， 不 使 用 i2c-dev.c 


第 一 个 设备 驱动 的 写法 :在 板 级 中 填充 关于 i2c 设备 的 硬件 信息 ，i2c_client 是 内 
核 根 据 板 级 代码 自动 生成 的 
不 需要 我 们 单独 来 填充 i2c_client 结构 。 











1. 填 充 板 级 信息 ， 使 用 i2c_board info 结构 体 
struct 12c board info { 
char  typelI2C NAME SIZE]; 
unsigned short flags; /* 标志 位 */ 
unsigned short addr; /* 设备 地 址 */ 
void *platform data; /* 用 来 传递 私有 的 数据 */ 
struct dev_archdata *archdata; /* 也 可 以 用 来 传递 私有 的 数据 */ 
int irq; /* 中断 号 */ 
35 
说 明 :i2c_board_info 必须 初始 化 两 个 字段 ， 分 别 是 设备 名 和 设备 地 址 ， 对 应 了 
i2c_client 的 name 以 及 i2c_client 的 addr. 


说 明 :type 是 设备 名 称 ， 它 和 驱动 程序 的 name 字段 进行 匹配 , 使 用 方式 类 似 于 下 
面 的 (从 linux 内 核 摘 录 ) 
static struct twl4030 platform data sdp3430 twldata = { 

.irq base = TWL4030 IRQ BASE, 

.irq_end = TWL4030_ IRQ END, 


/* platform_data for children goes here */ 


.bci = &sdp3430 bci data, 

-gpio = &sdp3430 gpio data, 
.madc = &sdp3430 madc data, 
.keypad = &sdp3430 kp data, 


usb = &sdp3430 usb data, 


.VaUX1 = &sdp3430 vauxl, 
.Vaux2 = &sdp3430 vaux2, 
.vaux3 = &sdp3430 vaux3, 
.Vaux4 = &sdp3430_vaux4, 
.vmmcl = &sdp3430 vmmcl, 
.Vmmc2 = &sdp3430 vmme2, 
.vsim = &sdp3430 vsim, 
.vdac = &sdp3430 vdac, 
.vpll2 = &sdp3430 vpll2, 


}; 
static struct 12c board info initdata sdp3430 i2c boardinfo[] = { 
{ 





I2C_ BOARD INFO("tw14030", 0x48), /* 提示 :ic 设备 本 来 的 地 址 是 8 
位 ， 但 是 linux 和 裸 机 程序 是 有 一 定 的 区 别 的 ， 这 里 不 能 够 使 用 8 
位 来 代表 设备 地 址 ， 一 般 用 高 7 位 来 代表 i2c 的 设备 地 址 ， 一 般 真实 的 地 址 右 移 
一 位 得 到 linux 的 i2c 的 设备 地 址 */ 

flags = DC CLIENT WAKE, 

irq =INT 34XX SYS NIRQ, 

.platform data = &sdp3430 twldata, 





b 
HE 


2. 注 册 平 台 设 备 

板子 上 没有 一 个 i2c 设备 ， 那 么 我 们 就 需要 注册 一 个 De 平台 设备 ， 注 册 函 数 如 
下 : 

i2c register board info(l, sdp3430 i2c boardinfo, 

ARRAY SIZE(sdp3430 i2c boardinfo)); 

说 明 : 第 一 个 参数 是 bus 号 ， 第 二 个 参数 是 board info 结构 ， 第 三 个 参数 是 大 小 。 


























如 果 按 照 以 上 的 这 种 方式 填充 ， 那 么 我 们 不 需要 填充 i2c_client 结构 ， 这 个 结构 
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会 被 操作 系统 根据 i2c board info 结构 
自动 填充 。 


注意 :i2c 的 设备 i2c_client 不 是 在 ic register board info 的 时 候 填充 的 ， 是 在 创 
# i2c adapter 的 时 候 填 充 的 ， 它 会 根据 我 们 写 的 
板 级 信息 来 填充 。 同 时 也 会 初始 化 adapter 结构 ， 一 个 i2c 的 设备 想 要 进行 工作 ， 
有 三 个 过 程 是 必 不 可 少 的 ， 创 建 i2c_cilent， 创 建 i2c_adapter 
创建 ic driver. 
struct i2c_client { 
unsigned short flags; /* div., see below * 
unsigned short addr; /* chip address - NOTE: 7bit */ 
/* addresses are stored in the */ 
/* LOWER 7 bits */ 
char name[I2C NAME SIZE]; 
struct 12c adapter “adapter; /* the adapter we siton  */ 
struct 12c driver “driver; /* and our access routines */ 




















struct device dev; /* the device structure $y 
int irq; /* irq issued by device +} 
struct list_head lists /* DEPRECATED */ 


struct list_head detected; 
struct completion released; 


HE 


3. 注 册 ic driver 和 匹配 对 应 的 i2c client(—Ÿ i2c client 对 应 一 个 相应 的 i2c 设 
备 ，i2c_client 携带 的 是 设备 相关 的 硬件 信息 ) 





每 一 个 i2c 的 设备 驱动 ， 必 须 首先 创建 一 个 i2c_driver 结构 体 ， 该 结构 体 包 含 了 
i2c 设备 探测 和 注销 的 一 些 基本 的 方法 和 信息 
我 们 在 编写 对 应 的 设备 驱动 的 时 候 主 要 填充 以 下 字段 
static const struct i2c_device_id ds1682_id[] = { 
"at24cxx", 0 }, 








{} 

3; 

static struct i2c_driver at24cxx driver = { 
.driver = { 

name ="at24cxx",/* 驱动 名 称 */ 

} 
.probe = at24cxx_probel, /* 匹配 函数 */ 
.ld table = ds1682 id 
.command = NULL, 

3; 














编号 好 结构 体 信 息 之 后 ， 需 要 在 模块 加 载 函数 中 注册 
i2c add driver(&at24cxx driver); 
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使 用 i2c add driver 向 内 核 注册 120 驱动 。 一 旦 驱动 和 设备 文件 相 匹 配 ， 那 么 
probel 函数 将 会 被 调用 。 





说 明 : 一 般 情况 下 只 需要 定义 probel 函数 以 及 remove 函数 即 可 ， 





4. 在 proble 函数 中 我 们 需要 定义 操作 函数 集 (字符 驱动 函数 集 ) 
static struct file operations at24cxx_fops = { 

.owner = THIS MODULE, 

ead —=at24cxx read, 

.Write = at24cxx write, 


5 


struct i2c_client *at24cxx clients /* 需要 提前 定义 好 ， 在 驱动 程序 中 */ 
static int at24cxx_probel(struct i2c_client *client, 
const struct i2c_device_id *id) 
{ 
int re; 
at24cxx_client = clients /* 说 明 ， 这 里 的 client 是 内 核 根 据 我 们 填充 的 板 级 
ARAMA */ 


major = register chrdev(0, "at24cxx", &at24cxx fops); 


cls = class create(THIS MODULE, "at24cxx"); 

class device create(cls, NULL, MKDEV(major, 0), NULL, "at24cxx"); /* 
/dev/at24cxx */ 

return rc; 


5. 定 义 i2c 的 write 和 read 函数 


static ssize_t at24cxx read(struct file *file, char _ user *buf, size_t size, loff t * 
offset) 
{ 

unsigned char address; 

unsigned char data; 

struct 12c msg msg[2]; 

int ret; 

if (size != 1) 

return -EINVAL; 


copy_from_user(&address, buf, 1); 


* 数据 传输 三 要 素 : 源 ,目的 ,长 度 */ 


/* 读 AT24CXX 时 ,要 先 把 要 读 的 存储 空间 的 地 址 发 给 它 */ 
msg[0].addr =at24cxx client->addr; /* 目的 */ 


msg[0].buf = &address; /* 源 */ 
msg[0].len =l; /地址 =1 byte */ 
msg[0].flags = 0; i* 表示 写 */ 
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static ssize t at24cxx_write(struct file “file, const char _ user *buf, size_t size, loff t 


/# 然后 启动 读 操 作 */ 
msg[1].addr =at24cxx client->addr; /* Wi */ 


msg[1].buf = &data; /* 目的 */ 
msg[l].len =l; /* 数据 =1 byte */ 


msg{!].flags = DC M RD; 


入 启动 传输 */ 
ret = i2c_transfer(at24cxx_client->adapter, msg, 2); 
if (ret = 2) 
{ 
copy_to_user(buf, &data, 1); 
return |; 
} 
else 
return -EIO; 


*offset) 


{ 


unsigned char val[2]; 
struct i2c msg msg[1]; 
int ret; 


/* address = buf[0] 
* data = buff 1] 
*/ 
if (size != 2) 
return -EINVAL; 


copy_from_user(val, buf, 2); 


i 数据 传输 三 要 素 : 源 ,目的 ,长 度 */ 
msg[0].addr =at24cxx client->addr; /* 目的 */ 
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msg[0].buf = val; Fe Ye */ 
msg[0].len =2; /# 地 址 + 数据 =2 byte */ 
msg[0].flags = 0; * 表示 写 */ 


ret = i2c_transfer(at24cxx_client->adapter, msg, 1); 


if (ret = 1) 
return 2; 
else 
return -EIO; 
} 
注意 ! !11111111111111111111111111 








第 二 个 设备 驱动 的 写法 :我 们 在 i2c 驱动 程序 手动 填写 关于 i2c 设备 相关 的 硬件 信 
息 ( 设 备 地 址 ， 访 问 的 时 钟 频率 等 ) 


1. 定 义 一 个 struct i2c_client *at24cxx_client; 结 构 体 ， 用 来 描述 硬件 信息 。( 在 程序 








中 进行 填充 ) 
定义 一 个 i2c_driver 结构 体 ， 因 为 这 里 不 存在 平台 设备 和 驱动 匹配 的 情况 ， 所 以 
不 需要 probel 函数 。 
static struct 12c driver at24cxx driver = { 
.driver = { 
name = "at24cxx", 
3, 


.attach_adapter = at24cxx attach, /* */ 

.detach client =at24cxx detach,/* * 
} 
定义 一 个 ji2c_client_ address data 结构 体 ， 这 个 结构 体 用 用 来 描述 设备 地 址 
static struct i2c client address data addr data = { 

normal i2c = normal addr, /* 要 发 出 S 信号 和 设备 地 址 并 得 到 ACK fas, 
才能 确定 存在 这 个 设备 */ 





.probe = ignore, 
.ignore = ignore, 
// forces = forces, /* 强制 认为 存在 这 个 设备 */ 


3. 设 备 的 注册 以 及 探测 功能 

这 一 步 很 关键 ， 按 照 标准 的 要 求 来 号 ， 则 linux 系统 会 自动 调用 相关 的 代码 去 探 
测 你 的 i2c 设备， 并且 添 加 到 系统 的 i2c 设备 列表 中 以 供 后 面 访问 

12 设备 的 探测 一 般 是 靠 设备 地 址 来 完成 的 , 那么 , 首先 就 需要 在 驱动 代码 中 声明 
里 要 探测 的 i2c 设备 的 地 址 列表 ， 以 及 一 个 宏 。 

在 这 里 我 们 自己 定义 一 个 数组 来 代表 i2c 设 备 的 地 址 (提示 :i2c 设 备 本 来 的 地 址 是 
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8 位 ， 但 是 linux 和 裸 机 程序 是 有 一 定 的 区 别 的 ， 这 里 不 能 够 使 用 8 

位 来 代表 设备 地 址 ， 一 般 用 高 7 位 来 代表 i2c 的 设备 地 址 ， 一 般 真 实 的 地 址 右 移 
一 位 得 到 linux 的 i2c 的 设备 地 址 )s 

tatic unsigned short normal addr[] = { 0x50, I2C CLIENT END }; /* 地 址 值 是 7 位 
*/ 

定义 的 i2c 设备 的 地 址 数组 必须 要 以 2C_CLIENT_END 字段 进行 结尾 。 





#include <linux/kernel.h> 
#include <linux/init.h> 
#include <linux/module.h> 
#include <linux/slab.h> 
#include <linux/jiffies.h> 
#include <linux/i2c.h> 
#include <linux/mutex.h> 
#include <linux/fs.h> 
#include <asm/uaccess.h> 


static unsigned short ignore[] = {I2C CLIENT END}; 
static unsigned short normal_addr[] = { 0x50, I2C_CLIENT END }; /* 地 址 值 是 7 
位 */ 

* 改 为 0x60 的 话 ， 由 于 不 存在 设 
备 地 址 为 0x60 的 设备 , 所 以 at24cxx detect 不 被 调用 */ 


static struct i2c client address data addr data = { 
.normal i2c = normal addr, /* 要 发 出 $ 信号 和 设备 地 址 并 得 到 ACK 信号 ， 
才能 确定 存在 这 个 设备 */ 





.probe = ignore, 
-ignore = ignore, 
// forces = forces, /* 强制 认为 存在 这 个 设备 */ 


FE 


static struct 12c driver at24cxx driver; 


static int major; 
static struct class *cls; 
struct 12c client *at24cxx client; 


static ssize t at24cxx read(struct file *file, char _ user *buf, size_t size, loff t * 
offset) 
{ 
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if (ret == 2) 
{ 
copy_to_user(buf, &data, 1); 
return |; 
} 
else 
return -EIO; 
} 
static ssize t at24cxx write(struct file *file, const char _ user *buf, size_t size, loff t 
*offset) 
{ 


unsigned char address; 
unsigned char data; 
struct 12c msg msg[2]; 
int ret; 


/* address = buf[0] 
* data = buff 1] 
*/ 
if (size != 1) 
return -EINVAL; 


copy_from_user(&address, buf, 1); 


* 数据 传输 三 要 素 : 源 ,目的 ,长 度 */ 


/* 读 AT24CXX 时 ,要 先 把 要 读 的 存储 空间 的 地 址 发 给 它 */ 


msg[0].addr =at24cxx client->addr; /* 目的 */ 


msg[0].buf = &address; /* We */ 
msg[0].len =l; /* 地 址 =1 byte */ 
msg[0].flags = 0; i gon * 


/# 然后 启动 读 操作 */ 
msg[!].addr =at24cxx client->addr; /* Wi */ 
msg[l].buf = &data; /* 目的 


*/ 


msg[l].len =l; /* 数据 =1 byte */ 


msg[!].flags = DC M RD; 


ret = i2c_transfer(at24cxx_client->adapter, msg, 2); 


unsigned char val[2]; 
struct 12c_msg msg[1]; 
int ret; 


FORTE */ 
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/* address = buf[0] 
* data = buff 1] 
$7 
if (size != 2) 
return -EINVAL; 


copy_from_user(val, buf, 2); 


* 数据 传输 三 要 素 : 源 ,目的 ,长 度 */ 
msg[0].addr =at24cxx client->addr; /* 目的 */ 


msg[0].buf = val; fe Oe */ 
msg[0].len = 2; /* 地 址 + 数据 =2 byte */ 
msg[0].flags = 0; i 表示 与 */ 


ret = i2c_transfer(at24cxx_client->adapter, msg, 1); 
if (ret = 1) 

return 2; 
else 

return -EIO; 


static struct file operations at24cxx_fops = { 


b 


.owner = THIS MODULE, 
ead —=at24cxx read, 
.Write = at24cxx write, 


static int at24cxx detect(struct i2c adapter *adapter, int address, int kind) 


{ 


printk("at24cxx_detect\n"); 


/* 构 构 一 个 i2c_client 结构 体 : 以 后 收 改 数据 时 会 用 到 它 */ 
at24cxx client = kzalloc(sizeof(struct 12c client), GFP_KERNEL); 
at24cxx client->addr = address; 

at24cxx_client->adapter = adapter; 

at24cxx_client->driver = &at24cxx_driver; 
strepy(at24cxx_client->name, "at24cxx"); 


/* $ i2c_client F i2c adapter 关联 起 来 */ 


i2c_attach_client(at24cxx_client); 


major = register chrdev(0, "at24cxx", &at24cxx_fops); 
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cls = class create(THIS MODULE, "at24cxx"); 
class device create(cls, NULL, MKDEV (major, 0), NULL, "at24cxx"); /* 


/dev/at24cxx */ 


return 0; 


static int at24cxx_attach(struct i2c adapter *adapter) 


{ 


PRE, ALIEN ee */ 
return i2c probe(adapter, &addr data, at24cxx detect); 


static int at24cxx detach(struct i2c client *client) 


{ 


printk("at24cxx_detach\n"); 

class device destroy(cls, MKDEV(major, 0)); 
class destroy(cls); 

unregister chrdev(major, "at24cxx"); 


i2c detach client(client); 
kfree(i2c get _clientdata(client)); 


return 0; 


#1. 分 配 一 个 ic driver 结构 体 */ 
#2. 设置 ic driver 结构 体 */ 
static struct 12c driver at24cxx driver = { 


HE 


.driver = { 
.name = "at24cxx", 
3, 
.attach_adapter = at24cxx_attach, /* 这 个 函数 是 相当 于 probel 的 作用 */ 
.detach client = at24cxx detach, 


static int at24cxx_init(void) 


{ 


i2c add driver(&at24cxx driver); 
return 0; 
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static void at24cxx_exit(void) 


{ 
i2c del driver(&at24cxx driver); 


module init(at24cxx init); 
module exit(at24cxx exit); 


MODULE LICENSE( GPL ); 
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Spi 驱动 编写 





spi 驱动 程序 的 编写 (参考 内 核 代码 ) 

在 linux 内 核 中 ，spi 有 系统 自 带 的 设备 驱动 程序 -spidev.c。 在 编写 spi 驱动 程序 
的 时 候 我 们 也 要 按照 板 级 -总 线 -驱动 的 方式 进行 编写 。 内 核 已 经 包含 了 spi 控制 
器 驱动 ， 我 们 只 需要 编写 设备 驱动 程序 和 初始 化 spi_master 

这 一 点 和 i2c 是 一 样 的 ，spi 驱动 程序 的 编写 和 i2c 采用 的 是 一 样 的 方式 编写 。 
spi 驱动 由 三 部 分 组 成 ， 分 别 是 core，spi master 以 及 spi_drivers( 一 个 spi_master 
代表 一 个 spi 主 控制 器 ， 这 部 分 驱动 一 般 不 用 我 们 自己 编写 , linux 内 核 一 般 自 带 
Jo) 

一 个 spi_device 代表 一 个 外 围 的 spi HT, spi master 注册 完成 之 后 会 扫描 bsp 
中 注册 的 spi 设备 链表 ， 并 向 spi bus 注册 。 

spi 的 读 写 是 调用 spi_transfer 来 完成 的 ， 它 通过 构造 spi message 来 实现 的 ， 这 一 
点 类 似 于 i2c 设备 的 发 送 与 接收 。 

Spi message 描述 一 次 完整 的 传输 , 即 cs 信号 线 从 高 - 低 -高 这 样 一 个 过 程 。 
spi_message 代表 了 spi 的 下 消息 ， 它 由 多 个 spi transfer 段 组 成 的 ， 这 个 传输 队 
列 是 原子 的 ， 意 思 就 是 这 个 消息 在 传递 完成 之 前 不 会 被 抢占 。Spi message 由 多 
个 spi transfer 构成 ， 例 如 我 们 对 于 spi 外 设 的 读 操 作 可 以 分 解 成 为 两 个 


spi_transfer， 一 个 是 写 命令 ， 一 个 是 读数 据 。 







































































1. 在 板 级 文件 中 定义 具体 的 spi 设备 所 需要 的 硬件 信息 (填充 spi_board_info 结构 
用 于 初始 化 spi_device) 
static struct ads7846 platform data ads_info = { 


.model = 7843, 

.X_ min = 190; 
.X_max = 3830, 
-y_min = 190, 
-y_max = 3830, 
.vref delay usecs = 100, 
.Xx plate ohms = 450, 
.y_plate ohms = 250, 
.pressure max = 15000, 
.debounce max = |, 
.debounce rep = 0), 
.debounce tol = (~0), 


.get pendown state = ads7843 pendown state, 

3; 

static struct spi board info ek spi devices[] = { 

#if defined CONFIG MTD AT91 DATAFLASH CARD) 
{ /* DataFlash card */ 
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.modalias  ="mtd dataflash", 
.chip select = 0, 
.max speed hz = 15 * 1000 * 1000, 
bus num =0, 
J> 
#endif 
#if defined CONFIG TOUCHSCREEN ADS7846) || 
defined( CONFIG TOUCHSCREEN ADS7846 MODULE) 
{ 
.modalias = "ads7846", 
.chip select = 3, 
.max speed hz = 125000 * 26, /* (max sample rate @ 3V) * (cmd + data 
+ overhead) */ 


bus num =0, 
.platform data = &ads info, 
irq = AT91SAM9263_ID_IRQI, 
B 
#endif 


说 明 spi board info 根据 linux 的 内 核 版 本 不 同 定 义 也 有 所 不 同 ,但 是 大 体 上 是 相 
同 的 
struct Spl board info { 

char modalias[32]; 

const void *platform data; 





void “controller data; 
int irq; 

u32 max speed hz; 

ul6 bus_num; 

ul6 chip select; 

us mode; 


5 

说 明 : 第 一 个 参数 设备 的 名 称 ， 第 二 个 参数 是 用 来 传输 的 私有 的 数据 ， 第 三 个 参 
数 可 以 用 来 作为 cs 引 脚 的 控制 函数 的 入 口 地 址 ， 第 四 个 参数 是 中 断 ， 第 五 个 参 
数 是 最 大 的 传输 频率 ， 第 六 个 参数 是 bus 号 (实际 指 的 是 对 应 的 spi 的 寄存 器 )， 
第 七 个 参数 是 片 选 信号 (这 里 的 片 选 信号 是 片 选 引 脚 编号 的 索引 ， 编 号 索引 不 超 
XE num cs 的 数目 ， 那 么 真正 的 片 选 引 脚 在 什么 地 方 声明 的 呢 ? )， 第 八 个 参数 是 
spi 的 传输 模式 。 





























2 .编写 驱动 程序 (主要 参考 内 核 代 码 的 spidev.c- 这 里 需要 感谢 2 群 的 一 位 同学 , 我 
也 参考 了 他 发 给 我 的 spi 的 驱动 代码 ) 
构造 spi_srivers 数据 结构 
static struct spi driver spidev spi = { 
.driver = { 





1 .name = "spidev", 
2 owner = THIS MODULE, 
3 3, 
4 .probe =spidev probe, 
5 .remove = _ devexit p(spidev remove), 
6 
7 /* NOTE:  suspend/resume methods are not necessary here. 
8 * We don't do anything except pass the requests to/from 
9 * the underlying controller. The refrigerator handles 
10 * most issues; the controller driver handles the rest. 
11 +? 
2 % 
13 ”说 明 :这 里 的 参数 我 不 再 说 明 。 
14 
15 ”注册 spi driver 结构 体 
16 status = spl register driver(&spidev spi); 
17 LAR: linux 中 你 必须 遵守 一 个 规则 ， 定 义 了 一 般 就 需要 注册 。 
18 
19 ”定义 一 个 操作 函数 集 ， 然 后 注册 进 内 核 
20 static struct file operations spidev_fops = { 
21 .owner= THIS MODULE, 
22 /* REVISIT switch to aio primitives, so that userspace 
23 * gets more complete API coverage. It'll simplify things 
24 * too, except for the locking. 
25 =} 
26 .Write = spidev_write, 
27 .read = spidev read, 
28 .Unlocked ioctl = spidev_ioctl, 
29 .open = spidev_ open, 
30 .release =  spidev release, 
31 fs 
32 status = register chrdev(SPIDEV MAJOR, "spi", &spidev fops); 
33 /* 注册 操作 函数 集 */ 
34 
35 ”3. 一 旦 设备 文件 和 驱动 匹配 ， 那 么 就 会 调用 probel 函数 
36 ”在 设备 函数 中 我 们 最 重要 的 几 个 步骤 就 是 得 到 设备 文件 描述 的 设备 信息 , 创建 一 
37 “个 字符 设备 
38 
39 static int spidev probe(struct spi device *spi) 
40 { 
41 struct spidev data  *spidev; 
42 int status; 
43 unsigned long minor; 


上 
下 
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/* Allocate driver data */ 
spidev = kzalloc(sizeof(*spidev), GFP KERNEL); 
if (!spidev) 

return -ENOMEM; 


/* Initialize the driver data */ 

spidev->spi = spi; 

spin lock init(&spidev->spi lock); 
mutex_init(&spidev->buf lock); 

INIT LIST HEAD(&spidev->device entry); 


/* If we can allocate a minor number, hook up this device. 
* Reusing minors is fine so long as udev or mdev is working. 
a 
mutex lock(&device list lock); 
minor = find first zero bit(minors, N SPI MINORS); 
if (minor < N SPI MINORS) { 
struct device “dev; 


spidev->devt = MKDEV(SPIDEV MAJOR, minor); 
dev = device create(spidev class, &spi->dev, spidev->devt, 
spidev, "spidev%d.%d", 
spi->master->bus num, spi->chip_select); 
status = IS ERR(dev) ? PTR_ERR(dev) : 0; 
} else { 
dev_dbg(&spi->dev, "no minor number available!\n"); 
status = -ENODEV; 
} 
if (status == 0) { 
set_bit(minor, minors); 
list add(&spidev->device entry, &device list); 
} 


mutex unlock(&device list lock); 


if (status == 0) 
spi_set_drvdata(spi, spidev); 
else 
kfree(spidev); 
return status; 











说 明 ; 上 面 的 主要 的 步骤 已 经 有 红色 字体 标注 ， 其 他 的 步骤 并 不 是 最 重要 的 ， 可 








吉 合 内 核 的 spidev.c 驱动 程序 里 面 看 。 
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4.9 open, read, write 函数 
Open 函数 一 般 是 创建 字符 设备 ， 这 里 不 再 讲解 。 
重点 分 析 的 是 write 函数 以 及 read 函数 ,下 面 一 一 进行 讲解 (摘录 自 内 核 的 一 可 以 
参考 spidev.c 文件 ) 
static int m25p80_read(struct mtd info *mtd, loff t from, size_t len, 
size_t *retlen, u_char *buf) 





{ 
struct m25p *flash = mtd to m25p(mtd); 


struct spi_transfer t[2]; 
struct spi message m; 
DEBUG(MTD DEBUG LEVEL2, "%s: %s %s 0x%08x, len %zd\n", 
dev name(&flash->spi->dev), func, "from", 
(u32)from, len); 
/* sanity checks */ 
if (!len) 
return 0; 
if (from + len > flash->mtd.size) 
return -EINVAL; 

spi message init(&m); /* 初始 化 spi_ message */ 
memset(t, 0, (sizeof t)); 
/* NOTE: 

* OPCODE FAST READ (if available) is faster. 

* Should add 1 byte DUMMY BYTE. 

*/ 
t[0].tx_buf = flash->command; /* 命令 */ 
t[0].len = CMD SIZE + FAST_READ DUMMY BYTE; /* 定义 第 一 个 

transfer 的 写 指针 和 长 度 */ 

spi message add tail(&t[0], &m); /* 添加 到 spi message 中 */ 
t[1].rx_buf =buf; = /* 读 的 数据 保存 的 缓冲 区 */ 
t[l].len=len; /* 第 二 个 transfer 的 读 指针 以 及 长 度 */ 
spi message add tail(&t[1], &m); /* 添加 到 spi message 中 */ 


/* Byte count starts at zero. */ 
if (retlen) 
*retlen = 0; 
mutex lock(&flash->lock); 
/* Wait till previous write/erase is done. */ 
if (wait till ready(flash)) { 
/* REVISIT status return?? */ 
mutex _unlock(&flash->lock); 
return |; 


} 
/* FIXME switch to OPCODE FAST READ. It's required for higher 
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* clocks; and at this writing, every chip this driver handles 
* supports that opcode. 
+} 
/* Set up the write data buffer. */ 
flash->command[0] = OPCODE READ; 
flash->command|[1] = from >> 16; 
flash->command|[2] = from >> 8; 
flash->command{2] = from; 
spi_sync(flash->spi, &m);  /* 调用 spi masster 发 送 spi message */ 
*retlen = m.actual_length - CMD SIZE - FAST READ DUMMY BYTE; 
mutex_unlock(&flash->lock); 
return 0; 


} 


说 明 : 在 编写 read 函数 的 时 候 ， 主 要 涉及 到 一 下 几 个 步 又 : 

1. 定义 spi message 

2. 定义 spi transfer 

3. 初始 化 spi message 

4. 填充 spi_transfer〈 对 于 读 的 操作 需要 两 个 步骤 ，!1. 读 取 的 spi 外 设 的 寄存 器 的 
地 址 ，2， 读 取 的 值 保存 的 buf。) 

5. Jia) spi 发 送 spi_sync:->spi_sync 为 同步 发 送 ， 在 调用 这 个 函数 的 时 候 就 开始 
传输 ， 还 可 以 用 spi_async 异步 方式 ， 就 是 调 了 这 个 函数 但 是 这 个 函数 的 执行 时 
间 不 确定 ， 所 以 在 使 用 异步 方式 的 时 候 需 要 指定 回调 函数 。 我 们 在 这 里 也 可 以 选 
择 一 些 封 装 的 更 好 的 函数 进行 调用 int spi_write then read(struct spi device 
*spi,const u8 *txbuf, unsigned n_tx,u8 *rxbuf, unsigned n 1x)。 第 一 个 参数 是 spi 设 
备 地 址 ， 第 二 个 参数 是 需要 发 送 的 数据 ， 第 三 个 参数 是 发 送 数据 的 长 度 ， 第 四 个 
参数 是 接收 的 数组 ， 第 五 个 参数 是 需要 接收 数据 的 字 节 数 。( 关 于 这 个 函数 怎么 
使 用 将 在 后 面 进 行 说 明 )。 




















static int m25p80 write(struct mtd_ info *mtd, loff t to, size_t len, 
size_t *retlen, const u_char *buf) 
{ 
struct m25p *flash = mtd to m25p(mtd); 
u32 page offset, page size; 
struct spi_transfer t[2]; 
struct spi message m; 
DEBUG(MTD DEBUG LEVEL2, "%s: %s %s 0x%08x, len Yozd\n", 
dev name(&flash->spi->dev), func, "to", 
(u32)to, len); 
if (retlen) 
*retlen = 0; 
/* sanity checks */ 
if (tlen) 
return(0); 
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if (to + len > flash->mtd.size) 
return -EINVAL; 
spi message init(&m); 
memset(t, 0, (sizeof t)); 
t[0].tx_buf = flash->command; 
t[0].len = CMD SIZE; 
spi message add tail(&t[0], &m); 
t[ 1 ].tx_buf = buf; 
spi message add tail(&t[1], &m); 
mutex lock(&flash->lock); 
/* Wait until finished previous write command. */ 
if (wait till ready(flash)) { 
mutex_unlock(&flash->lock); 
return |; 
} 
write_enable(flash); 
/* Set up the opcode in the write buffer. */ 
flash->command[0] = OPCODE PP; 
flash->command|[1!] = to >> 16; 
flash->command|[2] = to >> 8; 
flash->command|[3] = to; 
/* what page do we start with? */ 
page_offset = to % FLASH PAGESIZE; 
/* do all the bytes fit onto one page? */ 
if (page_offset + len <= FLASH PAGESIZE) { 
t[1].len = len; 
spi_sync(flash->spi, &m); 
*retlen = m.actual length - CMD SIZE; 
} else { 
u32 13 
/* the size of data remaining on the first page */ 
page size = FLASH PAGESIZE - page offset; 
t[1].len = page size; 
spi_sync(flash->spi, &m); 
*retlen = m.actual length - CMD SIZE; 
/* write everything in PAGESIZE chunks */ 
for (i = page size; i < len; i += page size) { 
page size = len - i; 
if (page size > FLASH PAGESIZE) 
page size = FLASH PAGESIZE; 


/* write the next page to flash */ 
flash->command{1] = (to + i) >> 163 
flash->command[2] = (to + i) >> 8; 
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flash->command[3] = (to + i); 

t[l].tx buf = buf + i; 

t[1].len = page size; 

wait_till_ready(flash); 

write _enable(flash); 

spi_sync(flash->spi, &m); 

if (retlen) 

*retlen += m.actual_length - CMD_ SIZE; 

} 


} 
mutex_unlock(&flash->lock); 


return 0; 


} 





接收 的 过 程 和 发 送 的 过 程 类 似 ， 这 里 不 再 重复 说 明 
驱动 程序 的 编写 大 概 就 是 这 些 ， 下 面 分 析 用 户 态 的 应 用 程序 











5.spi 的 应 用 程序 和 i2c 也 极其 的 类 似 ， 都 是 在 用 户 空 间 构 造 message 结构 体 ， 在 
linux 内 核 中 已 经 有 了 spi 的 用 户 程序 ， 程 序 位 于 内 核 目 录 的 
(Documentation/spi/spitest.c)， 用 户 态 的 程序 不 再 进行 分 析 。( 用 户 态 主要 填充 

spi ioc transfer 结构 体 )。 











说 明 : 在 我 们 编写 spi 的 驱动 程序 的 时 候 , 完全 可 以 修改 spidev.c 中 的 代码 ,在 linux 
内 核 中 一 个 spi 的 主 控制 器 最 多 能 够 挂 载 32 个 spi 的 外 设 ， 所 有 的 spi 的 外 设 的 
驱动 程序 都 可 以 按照 spidev.c 的 内 核 驱 动 修 改 得 到 , 我 们 只 需要 填写 对 应 的 板 级 
信息 ， 但 是 cs 引 脚 应 该 怎么 指定 ? 在 spi board info 结构 体 中 没有 指定 cs 的 引 
fil, 只 有 一 个 select cs 这 个 引 脚 是 cs 引 脚 的 索引 编写 , 不 代表 真正 的 spi 设备 的 
cs 引 脚 。 一 个 spi 控制 器 上 挂 载 的 spi 外 设 的 select cs 一 定 不 能 一 样 ， 你 可 以 从 
0 依次 递增 ， 但 是 绝对 不 能 够 超过 该 控制 器 上 所 能 够 支持 的 外 设 总 数 (一 般 是 在 
spi_master 结构 体 中 设置 )， 根 据 arm 芯片 的 设计 ， 一 个 spi 控制 器 只 能 挂 载 32 
个 spi 的 外 设 。 

















DMA 驱动 程序 的 编写 (参考 韦 东 山 的 驱动 代码 ) 


Dma 一 般 用 在 大 容量 数据 的 传输 模式 中 ， 比 如 说 视频 流 等 ， 在 cpu 使 能 dma 模 
式 之 后 ， 能 够 不 需要 cpu 的 参与 就 能 够 在 内 存 - 内 存 ， 内 存 - 外 设 ， 外 设 - 内 存 ， 外 
设 到 外 设 之 间 传 递 数据 ，dma 的 工作 模式 如 下 : 

VO 向 DMAC 发 送 请 求 ->DMAC 向 CPU 发 送 请 求 ->CPU 相应 DMAC 的 请 求 
->DMAC FH IO 发 送 请 求 ->DMAC 发 送 内 存 地 址 ->DMAC 发 出 控制 信号 ->DMA 
开始 传输 ->DMAC 传输 结束 。 

注意 :DMA 是 在 两 个 物理 地 址 间 传 输 数 据 。 


























在 linux 内 核 中 ， 如 果 要 编写 dma 的 驱动 程序 ， 一 般 需 要 调用 一 下 的 一 系列 初始 
化 函数 : 

Dma cap zero, dma cap set, dma request channel， 申 请 buf, sg init one, 
device control, dma map sg, device prep slave sg, dmaengine submit, 

device issue pending 等 函数 。 











在 我 们 自己 写 的 驱动 程序 中 可 以 按照 一 下 等 方式 来 编写 我 们 的 dma 驱动 程序 。 
request_irq{iRQ DMA3, s3c dma irq, 0, "s3c dma", 1)  /* 申请 dma 中断 */ 
说 明 : 在 我 们 申请 中 断 的 时 候 ， 寄 存 器 中 断 与 外 部 中 断 是 不 同 的 ， 寄 存 器 中 断 的 
触发 条 件 直接 填 0， 外 部 中 断 有 触发 条 件 ， 我 们 可 以 选择 低 电 平 触发 ， 高 电 平 触 
发 ， 下 降 沿 触发 ， 上 升 沿 触发 ， 双 边沿 触发 等 ， 寄 存 器 中 断 的 编写 和 外 部 中 断 的 
编写 时 截然 不 同 的 ， 在 实际 的 使 用 中 需要 注意 。 











2. 申请 内 存 空间 :dma alloc writecombine 

在 这 里 我 们 假设 是 在 内 存 -内 存 之 间 传 递 数据 。 那么 我 们 需要 申请 sro 内 
存 空间 和 dst 内 存 空 间 (寄存 器 到 内 存 , 寄存 器 到 寄存 器 之 间 的 程序 讲解 会 在 后 面 
进行 说 明 。) 





